Skip to content

docs: add v3 upgrade troubleshooting and index guide links - #1809

Open
Angel-4903 wants to merge 1 commit into
hashicorp:mainfrom
Angel-4903:docs/v3-upgrade-troubleshooting
Open

docs: add v3 upgrade troubleshooting and index guide links#1809
Angel-4903 wants to merge 1 commit into
hashicorp:mainfrom
Angel-4903:docs/v3-upgrade-troubleshooting

Conversation

@Angel-4903

Copy link
Copy Markdown
Contributor

Add a Troubleshooting section to the v3 upgrade guide covering the 'Blocks of type "kubernetes" are not expected here' error introduced by the SDKv2 -> Terraform Plugin Framework migration, with a block-to-attribute mapping table and a v2 pinning fallback (#1637). Also document the macOS OCI registry keychain login failure and its workarounds (#989).

Create templates/guides/v3-upgrade-guide.md as the generation source for the existing docs/guides/v3-upgrade-guide.md, and link both upgrade guides from the provider index template and rendered index page.

Rollback Plan

If a change needs to be reverted, we will publish an updated version of the library.

Changes to Security Controls

Are there any changes to security controls (access controls, encryption, logging) in this pull request? If so, explain.

Description

Acceptance tests

  • Have you added an acceptance test for the functionality being added?

Release Note

Release note for CHANGELOG:

...

References

Community Note

  • Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
  • If you are interested in working on this issue or have submitted a pull request, please leave a comment

Add a Troubleshooting section to the v3 upgrade guide covering the
'Blocks of type "kubernetes" are not expected here' error introduced by
the SDKv2 -> Terraform Plugin Framework migration, with a block-to-attribute
mapping table and a v2 pinning fallback (hashicorp#1637). Also document the macOS
OCI registry keychain login failure and its workarounds (hashicorp#989).

Create templates/guides/v3-upgrade-guide.md as the generation source for the
existing docs/guides/v3-upgrade-guide.md, and link both upgrade guides from
the provider index template and rendered index page.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@Angel-4903
Angel-4903 requested review from a team, iam404 and rigalGit as code owners July 6, 2026 05:54
@hashicorp-cla-app

Copy link
Copy Markdown

CLA assistant check

Thank you for your submission! We require that all contributors sign our Contributor License Agreement ("CLA") before we can accept the contribution. Read and sign the agreement

Learn more about why HashiCorp requires a CLA and what the CLA includes


Angel Raphael seems not to be a GitHub user.
You need a GitHub account to be able to sign the CLA.
If you have already a GitHub account, please add the email address used for this commit to your account.

Have you signed the CLA already but the status is still pending? Recheck it.

1 similar comment
@hashicorp-cla-app

Copy link
Copy Markdown

CLA assistant check

Thank you for your submission! We require that all contributors sign our Contributor License Agreement ("CLA") before we can accept the contribution. Read and sign the agreement

Learn more about why HashiCorp requires a CLA and what the CLA includes


Angel Raphael seems not to be a GitHub user.
You need a GitHub account to be able to sign the CLA.
If you have already a GitHub account, please add the email address used for this commit to your account.

Have you signed the CLA already but the status is still pending? Recheck it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant